home *** CD-ROM | disk | FTP | other *** search
/ Aminet 3 / Aminet 3 - July 1994.iso / Aminet / gfx / pbm / manuals.lha / netpbm / man / pnmhistmap.man < prev    next >
Text File  |  1994-03-01  |  3KB  |  133 lines
  1.  
  2.  
  3.  
  4.      pnmhistmap(1)        AMIGA (25 October 1993)        pnmhistmap(1)
  5.  
  6.  
  7.  
  8.      NAME
  9.           pnmhistmap - draw a histogram for a PGM or PPM file
  10.  
  11.      SYNOPSIS
  12.           pnmhistmap [-black] [-white] [-max N] [-verbose] [pnmfile]
  13.  
  14.      DESCRIPTION
  15.           Reads a portable anymap as input, although bitmap (PBM)
  16.           input produces an error message and no image.  Produces an
  17.           image showing a histogram of the color (or gray) values in
  18.           the input.  A graymap (PGM) input produces a bitmap output.
  19.           A pixmap (PPM) input produces pixmap output with three
  20.           overlaid histograms:  a red one for the red input, a green
  21.           one for the green input, and a blue one for the blue input.
  22.           The output is fixed in size: 256 pixels wide by 200 pixels
  23.           high.
  24.  
  25.      OPTIONS
  26.           -black
  27.                Ignores the count of black pixels when scaling the
  28.                histogram.
  29.  
  30.           -white
  31.                Ignores the count of white pixels when scaling the
  32.                histogram.
  33.  
  34.           The -black and -white options, which can be used seperately
  35.           or together, are useful for images with a large percentage
  36.           of pixels whose value is zero or 255, which can cause the
  37.           remaining histogram data to become unreadbaly small.  Note
  38.           that, for pixmap inputs, these options apply to all colors;
  39.           if, for example, the input has a large number of bright-red
  40.           areas, you will probably want to use the -white option.
  41.  
  42.           -max N
  43.                Force the scaling of the histogram to use N as the
  44.                largest-count value.  This is useful for inputs with a
  45.                large percentage of single-color pixels which are not
  46.                black or white.
  47.  
  48.           -verbose
  49.                Report the progress of making the histogram, including
  50.                the largest-count value used to scale the output.
  51.  
  52.           All flags can be abbreviated to their shortest unique
  53.           prefix.
  54.  
  55.      BUGS
  56.           Assumes maxval is always 255.  Images with a smaller maxval
  57.           will only use the lower-value side of the histogram.  This
  58.           can be overcome either by piping the input through "pnmdepth
  59.           255" or by cutting and scaling the lower-value side of the
  60.  
  61.  
  62.  
  63.      Page 1                                           (printed 3/1/94)
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.      pnmhistmap(1)        AMIGA (25 October 1993)        pnmhistmap(1)
  71.  
  72.  
  73.  
  74.           histogram.  Neither is a particularly elegant solution.
  75.  
  76.           Should allow the output size to be specified.
  77.  
  78.      SEE ALSO
  79.           pgmhist(1), ppmhist(1), pgm(5), ppm(5)
  80.  
  81.      AUTHOR
  82.           Wilson H. Bent. Jr. (whb@usc.edu).
  83.  
  84.  
  85.  
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.      Page 2                                           (printed 3/1/94)
  130.  
  131.  
  132.  
  133.